package com.quectel.core.module.officialaccounts.service;


import com.quectel.core.module.officialaccounts.dto.OfficialAccountsBindingDto;

import java.util.List;
import java.util.Map;

/**
 * @author caolu
 * @email louis.cao@quectel.com
 * @date 2021-12-14 14:23:37
 */
public interface OfficialAccountsBindingService {

    /**
     * 查询人在微信公众号下的绑定关系 可能多个人在同一个公众号下登录同一个账号 所以返回值是多个（多个openId）
     * 查询是否有绑定(主要是查人的openId)
     *
     * @param personType
     * @param personId
     * @param type
     * @param appId
     * @return
     */
    List<OfficialAccountsBindingDto> selectCacheBy(Byte personType, Long personId, Byte type, String appId);

    /**
     * 查询人在微信公众号下的绑定关系 可能多个人在同一个公众号下登录同一个账号 所以返回值是多个（多个openId）
     * 查询是否有绑定(主要是查人的openId)
     *
     * @param personType
     * @param personId
     * @param type
     * @param appId
     * @return
     */
    List<OfficialAccountsBindingDto> selectBy(Byte personType, Long personId, Byte type, String appId);

    /**
     * 查询是否有绑定(主要查personId)
     *
     * @param type
     * @param appId
     * @param openId
     * @param personType
     * @return
     */
    OfficialAccountsBindingDto selectBy(Byte type, String appId, String openId, Byte personType);

    /**
     * 根据id查询一条记录 有缓存默认五分钟
     *
     * @param id
     * @return
     */
    OfficialAccountsBindingDto selectCacheById(Long id);

    /**
     * 根据id查询一条记录
     *
     * @param id
     * @return
     */
    OfficialAccountsBindingDto selectById(Long id);

    /**
     * 查询列表
     *
     * @param params
     * @return
     */
    List<OfficialAccountsBindingDto> queryList(Map<String, Object> params);

    /**
     * 查询数量
     *
     * @param params
     * @return
     */
    int queryTotal(Map<String, Object> params);

    /**
     * 存入一条记录
     *
     * @param dto
     * @return 存入数据的id
     */
    Long save(OfficialAccountsBindingDto dto);

    /**
     * 根据id更新一条记录 字段为null不更新
     *
     * @param dto
     */
    void updateById(OfficialAccountsBindingDto dto);

    /**
     * 根据id更新一条记录  字段为null会更新 建议先查询再更新
     *
     * @param dto
     */
    void updateAllColumnById(OfficialAccountsBindingDto dto);

    /**
     * 根据id删除一条记录
     *
     * @param id
     */
    void deleteById(Long id);

    /**
     * 批量删除
     *
     * @param ids
     */
    void deleteBatch(Long[] ids);


}
